Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add documentation for credHelper #950

Merged
merged 1 commit into from
Jun 4, 2020

Conversation

QiWang19
Copy link
Collaborator

@QiWang19 QiWang19 commented Jun 4, 2020

Add documentation for credHelper. Close containers/podman#1675

Signed-off-by: Qi Wang [email protected]

@QiWang19
Copy link
Collaborator Author

QiWang19 commented Jun 4, 2020

@TomSweeneyRedHat PTAL

}
```

For more information on Docker credential stores, please reference the [GitHub docker-credential-helpers project](https://github.com/docker/docker-credential-helpers/releases).
Copy link
Member

@rhatdan rhatdan Jun 4, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are these credential helpers not Stores and remove the extra Docker adjective.
For more information on credential helpers see: GitHub docker-credential-helpers project.

# SEE ALSO
buildah-login(1), buildah-logout(1), podman-login(1), podman-logout(1)
buildah-login(1), buildah-logout(1), podman-login(1), podman-logout(1), , skopeo-login(1), skopeo-logout(1)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Extra comma

@rhatdan
Copy link
Member

rhatdan commented Jun 4, 2020

@TomSweeneyRedHat PTAL

provided by `login`. If the credential helpers are configured for specific registries, the base64 encoded will not be used
for operations concerning credentials of the specified registries.

When the credential helper is in use on a Linux platform, the auth.json file would contain keys specify the registry domain, and values specify the suffix of the program to use (i.e. everything after docker-credential-). For example:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
When the credential helper is in use on a Linux platform, the auth.json file would contain keys specify the registry domain, and values specify the suffix of the program to use (i.e. everything after docker-credential-). For example:
When the credential helper is in use on a Linux platform, the auth.json file would contain keys that specify the registry domain, and values that specify the suffix of the program to use (i.e. everything after docker-credential). For example:

Is there supposed to be a dash at the end of docker-credential- in the parens at the end? I removed it in my suggestion.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

there should be a dash at the end, the api will append the config value to this string to look for binary.

@rhatdan
Copy link
Member

rhatdan commented Jun 4, 2020

LGTM

@@ -37,8 +37,28 @@ their accounts on quay.io and docker.io:
An entry can be removed by using a `logout` command from a container
tool such as `podman logout` or `buildah logout`.

In addition, credential helpers can be configured for specific registries and the credentials-helper
software can be used to manage the credentials in a more secure way than depending on the base64 encoded authentication
provided by `login`. If the credential helpers are configured for specific registries, the base64 encoded will not be used
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry, missed this last time!

Suggested change
provided by `login`. If the credential helpers are configured for specific registries, the base64 encoded will not be used
provided by `login`. If the credential helpers are configured for specific registries, the base64 encoded authentication will not be used

Add documentation for credHelper. Close containers/podman#1675

Signed-off-by: Qi Wang <[email protected]>
Copy link
Member

@TomSweeneyRedHat TomSweeneyRedHat left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM
Thanks @QiWang19 !

@rhatdan
Copy link
Member

rhatdan commented Jun 4, 2020

LGTM

@rhatdan rhatdan merged commit 4158eb2 into containers:master Jun 4, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

podman login should use credential helper if configured
3 participants